home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / xl227c.zip / XLIST.DOC < prev    next >
Text File  |  1993-03-26  |  52KB  |  1,297 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                           XLIST
  22.  
  23.                                           DISK MANAGER
  24.  
  25.                                           USERS GUIDE
  26.  
  27.                                           for the
  28.  
  29.                                           MS-DOS & OS/2
  30.  
  31.  
  32.  
  33.                                           by
  34.  
  35.                                           GARY W. WOOD
  36.  
  37.  
  38.                    *** READ CAREFULLY BEFORE USING XLIST ***
  39.                            PROGRAM LICENSE AGREEMENT
  40.  
  41. Xlist (tm) is NOT "Public Domain" and it is NOT "Freeware".  Xlist is
  42. a copyrighted software product developed and owned by Gary W. Wood.
  43. Xlist is distributed under the shareware concept.  You are free to
  44. copy and use the software for personal use and shareware
  45. distribution in its original, unmodified form provided no fee
  46. beyond reasonable media and/or shipping charges is levied.
  47.  
  48. If you are using the software for personal use, your required to
  49. license the software after a 21 day evaluation period for $25 and
  50. become a Xlist supporter.  Xlist supporters will receive the next
  51. major release free of charge and be keep informed of major
  52. developments for one (1) year.  A license is required for use of
  53. Xlist by corporations and institutions, and for its commercial
  54. distribution.  You may obtain a license for the use of Xlist by
  55. writing to me.  The license is for perpetual, non-exclusive use of
  56. any version.  Purchase orders and invoicing are acceptable.  If you
  57. have special requirements, such as licensing for an unlimited
  58. number of copies, local area networks, site licenses, or
  59. customization, please feel free to submit them in writing.  You may
  60. request a license for:
  61.  
  62.       o     an unlimited number of end user copies at a single site;
  63.       o     customization of messages and documentation,  an
  64.             additional fee may be required depending on the extent of
  65.             changes;
  66.       o     permission to distribute within your organization;
  67.       o     permission to include with your company's commercial
  68.             products;
  69.  
  70. The fee for a license depends on the estimated number of copies of
  71. the program that you will use.  If you wish to distribute Xlist
  72. with your own programs or hardware, write for a "Marketing
  73. License".  To use the discount schedule below, estimate the total
  74. number of copies that you may eventually use.
  75.  
  76.      2 to  9 computers ..... at $20 each
  77.     10 to 24 computers ..... at $16 each
  78.     25 to 49 computers ..... at $13 each
  79.     50 to 99 computers ..... at $10 each
  80.     100 or more computers .. $1000 one time fee
  81.  
  82. Regardless of the quantity, only one set of materials will be sent
  83. to you.  You may then make as many copies of it that are licensed.
  84. Maintenance is free.  Upgrades will be made available upon request.
  85. Technical support is available via mail, or through the Compuserve
  86. bulletin board systems (76156,317), at no charge.
  87.  
  88.                      Copyright (C) 1985-1992 Gary W. Wood
  89.  
  90.  
  91.  
  92.  
  93. If you use Xlist after the 21 day evaluation period a license fee
  94. of $25 will register you to receive a current version of Xlist.
  95. Please state the current version of Xlist that you have.  Send
  96. contributions to:
  97.  
  98.             Gary Wood
  99.             5401 Lakeview Road
  100.             North Little Rock, Arkansas  72116
  101.  
  102. All rights reserved.  Printed in the United States of America.  No
  103. part of this publication may be reproduced, stored in a retrieval
  104. system, or transmitted in any form or by any means, electronic,
  105. mechanical, photocopying, recording, or otherwise without the prior
  106. written permission from Gary W. Wood, 5401 Lakeview Road, North
  107. Little Rock, Arkansas, 72116.
  108.  
  109.  
  110.  
  111.  
  112.                                   DISCLAIMER
  113.  
  114. The author has taken due care in the preparation of this document
  115. and the associated program.  Insofar as specific mention of program
  116. features, the author believes the information to be true.  No
  117. warranty is made regarding the suitability of the program to be
  118. compatible with your computer.  Incidental and consequential
  119. damages caused by malfunction, defect, or otherwise are not the
  120. responsibility of Gary W. Wood, and to the extent permitted by law,
  121. and hereby excluded both for the property and, to the extent not
  122. unconscionable, for personal injury damage. (Some states or
  123. jurisdictions do not allow the exclusion or limitation of
  124. incidental or consequential damages, so the above limitation or
  125. exclusion may not apply to you.)  Gary W. Wood also reserves the
  126. right to make amendments to the contents of this document from time
  127. to time, to reflect changes made to the specification of the Xlist
  128. system or for any other reason.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. Xlist is a Trademark of Gary W. Wood.  IBM, IBM-PC, PC-XT, PC-AT,
  138. PS/2, DOS, OS/2, VM/CMS, FLIST, and PC-DOS are Trademarks of
  139. International Business Machines Corp. MS-DOS is a Trademark of
  140. Microsoft Corporation. CHAPTERS
  141.  
  142.  
  143.  
  144. 1.    Introduction                                                5
  145.  
  146. 2.    Getting Started                                             6
  147.  
  148. 3.    Invoking the Xlist Command                                  8
  149.  
  150. 4.    Using the Keyboard                                          9
  151.  
  152. 5.    Increasing background performance (OS/2)                    10
  153.  
  154. 6.    Mouse Support                                               11
  155.  
  156. 7.    Tagging Files                                               12
  157.  
  158. 8.    Use of the Xlist.CNF File                                   14
  159.  
  160. 9.    Maintaining the Xlist.PRO Profile                           15
  161.  
  162. 10.   Command Line Commands                                       26
  163. INTRODUCTION
  164.  
  165.  
  166.  
  167. WELCOME TO THE WORLD OF DISK MANAGEMENT USING
  168. Xlist - DISK UTILITY
  169.  
  170.       If you are new to PC-DOS, you have realized that commands
  171.       provided by PC-DOS are designed to be short and sweet.  This
  172.       program is designed as a tool to effectively provide the user
  173.       a friendly way to view files contained in sub-directories and
  174.       be able to execute programs and PC-DOS commands.
  175.  
  176.       Xlist was written in 1985 modelled after IBM's VM/CMS mini-
  177.       disk manager called FLIST.  FLIST is a full-screen utility
  178.       that runs under CMS that allows professional programmers using
  179.       IBM 370 architecture VM machines to view a structured list of
  180.       available files and launch applications and commands by just
  181.       entering the command next to the corresponding file.
  182.  
  183.       Xlist provides a greatly enhanced version of FLIST providing
  184.       a powerful platform for executing MS-DOS commands, hard disk
  185.       management and launching applications.  Much time has been
  186.       used to make sure Xlist respects the current video mode and
  187.       tries to provide a natural feel that is easy to master.
  188.  
  189.  
  190. GETTING STARTED
  191.  
  192.  
  193.  
  194. WHAT KIND OF HARDWARE & SOFTWARE DO I NEED?
  195.  
  196.  
  197.       To use Xlist you need the following:
  198.  
  199.       An IBM-PC with hard disk, PC-AT, PS/2, or a very closely
  200.       compatible microcomputer.
  201.  
  202.       A color/graphics adapter, monochrome adapter, EGA, or VGA
  203.       adapter
  204.  
  205.       640K of RAM memory for best results.  The program requires at
  206.       least 135K of memory.
  207.  
  208.       One diskette drive
  209.  
  210.       DOS 2.1+ or OS/2 1.2+  (Note: OS/2 1.0 version available on
  211.       request.)
  212.  
  213.       Will use EMS, XMS, EXTended or DOS 5.0 high memory when available
  214.  
  215. WHAT DO I DO NOW
  216.  
  217.  
  218.       Installing Xlist to operate on your system is a simple
  219.       process.  You should start by copying the distribution
  220.       diskette and putting the original away in a safe place.
  221.  
  222.       Now, copy the files on the diskette or unarchive the
  223.       application to a directory on your hard disk searched by the
  224.       DOS PATH.  The PC-DOS "PATH" command specifies a directory
  225.       search order for commands and/or batch files that are not in
  226.       the current drive/directory.
  227.  
  228.       For best performance of Xlist when utilizing the capability to
  229.       page Xlist to a temporary file, set the following environment
  230.       parameter.
  231.  
  232.       (See the *OVERLAY option in Chapter 7 for more information.)
  233.  
  234.       SET TMP=D:\         <--- Point to RAM disk.
  235.  
  236.       You are now ready!
  237. INVOKING THE Xlist COMMAND
  238.  
  239.  
  240. WHAT ARE THE INVOKING PARAMETERS?
  241.  
  242.  
  243.       First, no parameters are mandatory, but under some conditions
  244.       you may want to specify them to limit or expand the directory
  245.       entries displayed.
  246.  
  247.       To invoke the program enter:
  248.  
  249.             Xlist [[d:][path][filename[.ext]] /L /A
  250.  
  251.       The optional parameters have the following definitions:
  252.  
  253.             [[d:][path][filename[.ext]] to specify the file and/or
  254.             files that will be initially be displayed by the Xlist
  255.             screen.
  256.  
  257.             [/L] is used to tell Xlist to display license
  258.             information.
  259.  
  260.             [/A] will instruct Xlist to display every file on the
  261.             drive.
  262.  
  263.             [/*] is used to provide override "Xlist.PRO" profile
  264. commands.
  265.  
  266.  
  267.       Examples:
  268.  
  269.       Execute Xlist loading the directory from the default drive
  270.       directory and the root directory of the C: drive.
  271.  
  272.       Xlist *.*   c:\*.*
  273.  
  274.       Activate the performance options for Xlist OS/2 to wait 10
  275.       seconds before going into idle mode.
  276.  
  277.       Xlist /*KEYWAIT=10      /*SLEEP=1000
  278.  
  279.       Execute Xlist and redefine hotkey to press alt & right shift
  280.       key and disable the mouse functions.
  281.  
  282.       Xlist /*hotkey=alt=rightshift       /*mouse=off USING THE KEYBOARD
  283.  
  284.  
  285. WHAT KEYS ON THE KEYBOARD DOES Xlist USE?
  286.  
  287.       Xlist uses the keyboard for communicating instructions from
  288.       you to Xlist.  The keyboard is used to enter commands, scroll
  289.       the display, and to invoke user-defined function keys.  These
  290.       are the keystroke commands used by Xlist.
  291.  
  292.       You may change command keys by using the "Alt-k" key.
  293.  
  294.       Defaults are defined as follows:
  295.  
  296.       Keystroke         Definition
  297.       Home              Position the cursor to the first character or entry.
  298.       End               Position the cursor to the last character or entry.
  299.       Ctrl-End          Erase data in the command line from the cursor
  300.                         to the end-of-line.
  301.       Alt-a             Change file attributes.
  302.       Alt-c             Change screen colors.
  303.       Alt-e             EGA/VGA video mode toggle switch.
  304.       Alt-f             Toggle to set Xlist to flush unexecuted
  305.                         commands when an error or CNTL-BREAK is
  306.                         encountered.
  307.       Alt-k             Change keyboard definitions.
  308.       Alt-s             Toggle between displaying filesize in K's
  309.                         or in total number of bytes.
  310.       Alt-t             Tag multiple files.
  311.       Alt-x             Exclude entry.
  312.       Esc               Exit Xlist.
  313.       Enter             Pass control to Xlist to process the command lines.
  314.       Ctrl-PgUp         Goto top of directory.
  315.       Ctrl-PgDn         Goto bottom of directory.
  316.       Ctrl-Enter        Process on the command next to cursor.
  317.       PgUp              Scroll up one screen.
  318.       PgDn              Scroll down one screen.
  319.       Shift-Shift       Popup the menu.
  320.       `                 Tag single entry toggle. (Key above TAB to left
  321.                         of "1")
  322. INCREASING BACKGROUND PERFORMANCE
  323.  
  324.  
  325.       When you use Xlist for OS/2 in the foreground and have another
  326.       application running in the background, OS/2 scheduling
  327.       conventions give the majority of the processing power to the
  328.       foreground application.  This can sometimes cause a dramatic
  329.       decrease in background processing performance.  Xlist of OS/2
  330.       avoids this possible decrease in performance by providing two
  331.       profile options that let you enhance your background
  332.       processing speed.  These profile commands are: *KEYWAIT and
  333.       *SLEEP.
  334.  
  335.       Why is there sometimes a decrease in background performance?
  336.       Xlist for OS/2 must continuously check for mouse movements and
  337.       keyboard shift status.  This is necessary for Xlist to display
  338.       shifted function key definitions and to sense mouse movements.
  339.       Because Xlist is always trying to gather this information, the
  340.       program is never really "idle" even when it appears to be.
  341.  
  342.  
  343. HOW THE PERFORMANCE OPTIONS WORK
  344.  
  345.  
  346.       When you use the *KEYWAIT and *SLEEP options, Xlist for OS/2
  347.       operates as explained in the example below.
  348.  
  349.       Example:
  350.  
  351.       You are running Xlist in the foreground, another application
  352.       in the background, and you're using the defaults for the
  353.       *KEYWAIT (5 seconds) and *SLEEP (1000 milliseconds).  When
  354.       using Xlist, if you do not make an entry for 15 seconds, Xlist
  355.       will become idle for 1/10 of a seconds (100 milliseconds).
  356.       When Xlist is idle, the background application is given
  357.       increased processing power resulting in an improved processing
  358.       speed.  At the end of the idle time Xlist checks for user
  359.       input.  If none is found, Xlist goes back into idle mode for
  360.       another 1/10 of a second.  Xlist continues the idle/check loop
  361.       until it detects user input.
  362.  
  363.       How does Xlist idle time affect you?  When Xlist is idle the
  364.       response to you input is delayed by the number of milliseconds
  365.       specified.  This means that your first couple of keystrokes
  366.       will not appear on the screen for a fraction of a second.
  367.       However, after you begin typing, Xlist comes out of the idle
  368.       mode and normal typing speed is resumed. MOUSE SUPPORT
  369.  
  370.  
  371. HOW DOES THE MOUSE INTERFACE WITH Xlist?
  372.  
  373.  
  374.  
  375.       Xlist will use a mouse device when available.  The mouse is
  376.       capable of scrolling the screen, executing function keys,
  377.       moving between directories, tagging & untagging entries, and
  378.       bring up a series of menus.  A mouse will have anywhere from
  379.       2 to 3 buttons.  For the purpose of this discussion, we will
  380.       call the buttons the left, center and right buttons.
  381.  
  382.       Scrolling: You may scroll the display by positioning the mouse
  383.       pointer to the top or bottom right most position and pressing
  384.       either the right or left button.  The left button will scroll
  385.       a full screen while the right button will scroll continuously
  386.       one entry at a time.
  387.  
  388.       Function Key: Position the mouse pointer over the function key
  389.       definition on the last row of the display and press the left
  390.       button.
  391.  
  392.       Directories: Position the mouse pointer on the first row and
  393.       press the right button to move from the current directory to
  394.       the directories parent.  Position the mouse pointer to a
  395.       directory entry on the main screen area and double click the
  396.       left button to move to the corresponding directory.
  397.  
  398.       Tagging: Position the mouse pointer to the first entry to tag
  399.       and press the center button or both the left and right buttons
  400.       at the same time an drag the mouse pointer to tag multiple
  401.       entries.  Use the right button to untag already tagged
  402.       entries.
  403.  
  404.       Menus: Position the mouse pointer to the first row and click
  405.       the left button.
  406.  
  407. TAGGING FILES
  408.  
  409.  
  410.  
  411.       When using Xlist you normally view the directory structure and
  412.       process a series of MS-DOS commands against corresponding
  413.       directory entries.  This is normally executed by positioning
  414.       the highlighted line with the cursor keys to the directory
  415.       entry and entering a MS-DOS command beside the entry.
  416.  
  417.       If you would like to perform the same command to a series of
  418.       files you should navigate from page to page and tag files you
  419.       would like to execute the same command using the designated
  420.       "tag" key or using the alt-t command to globally tag multiple
  421.       files.
  422.  
  423.       After pressing the <ENTER> key, Xlist will process commands
  424.       starting with the first command located adjacent to a
  425.       directory entry.  Subsequent tagged entries will have that
  426.       command processed against that entry as if you had entered the
  427.       command over and over adjacent to each tagged directory entry.
  428.  
  429.  
  430.        LVL 1 - C:\                   (   8K) 158,447  PAGE 1 OF 15
  431.       DELETE                        <DIR>     12-17-91   7:20p ....
  432.       NOWHERE                       <DIR>     12-17-91   7:21p ....
  433.       OS2                           <DIR>     12-17-91   6:49p ....
  434.       ANIMATE  EXE  erase               19152 05-07-90   9:18p A...
  435.       ASTEROID EXE                      23936 06-22-90  11:47a A...
  436.       AUTOEXEC BAT  copy / a:            1048 12-22-91   3:58p ....
  437.       CONFIG   SYS                        417 12-22-91   8:11p ....
  438.       DASDDRVR SYS                       1170 03-02-90  12:00p ....
  439.       IMAGE    BAK  /a-r~erase          50688 12-23-91   8:21p .R..
  440.       KTCCACHE EXE                       3344 04-11-91  12:02p A...
  441.       OS2LDR   MSG                       7928 10-09-91   2:20p ....
  442.       SPOOL         cd              <DIR>     12-17-91   7:21p ....
  443.       STARTUP  CMD                         76 12-22-91   4:32p ....
  444.       IMAGE    DAT                      50688 12-23-91   8:21p ....
  445.  
  446.       In the example specified above we have tagged entries from ANIMATE.EXE
  447.       through KTCCACHE.EXE using the "tag" key causing Xlist to highlight the
  448.       tagged lines.  Then, we positioned the cursor to "ANIMATE.EXE" and entered
  449.       "erase", skipped to "AUTOEXEC.BAT" and entered "copy / a:", skipped to
  450.       "IMAGE.BAK", entered "/a-r~erase" and changed directory to C:\SPOOL.
  451.       What happens???
  452.  
  453.       Xlist will execute the MS-DOS "erase" command following by "ANIMATE.EXE"
  454.       causing the file to be deleted by MS-DOS...because the following line is
  455.       also tagged, Xlist will erase "ASTEROID.EXE"...the command is changed to
  456.       "copy / a:" causing Xlist to execute "copy AUTOEXEC.BAT a:"...then "copy
  457.       CONFIG.SYS a:"...then "copy DASDDRVR.SYS a:"...the command is changed to
  458.       "/a-r~erase" causing Xlist to remove the read-only file attribute and
  459.       erase "IMAGE.BAK"...then will erase the last tagged file
  460.       "KTCCACHE.EXE"...then will change directory to C:\SPOOL.
  461.  
  462.       You should note that the "~" character is used for logical command end
  463.       used to stack commands and the "/a-r" is an internal Xlist command used
  464.       to change file attributes.  You will see discussions of these commands
  465.       later within the documentation.
  466. USE OF THE Xlist.CNF FILE
  467.  
  468.  
  469. WHAT PARAMETERS ARE IN THE CONFIGURATION FILE?
  470.  
  471.  
  472.       The 'Xlist.CNF' file contains the initial keyboard and color settings.  You
  473.       may modify these using the "Alt-c" for color changes and the "Alt-k" for
  474.       keyboard changes.  If by some chance this file is corrupted, erase the
  475.       file and Xlist will recreate it to it's default values.  This file is
  476.       maintained by Xlist and cannot be edited by a text editor.  If you corrupt
  477.       the keyboard or color settings, Xlist will recreate the file if you will
  478.       erase the file.  It will be recreate in the current drive/directory if
  479.       Xlist.EXE is located in the directory or in the first path specified by the
  480.       MS-DOS PATH command.
  481.  
  482. MAINTAINING THE Xlist.PRO PROFILE
  483.  
  484.  
  485. WHAT PARAMETERS ARE IN THE PROFILE?
  486.  
  487.  
  488.       The 'Xlist.PRO' file is used to communicate a multitude of parameters to
  489.       Xlist that allow it to be tailored to your individual needs.  Use a text
  490.       editor, such as BRIEF, KEDIT, or EDLIN to modify the profile parameters
  491.       based on the following parameter descriptions.  There is no way the
  492.       provided profile will suit your needs and you should modify at least the
  493.       *PFKEYS and *EXECUTE parameters.
  494.  
  495.       The profile is found by Xlist by first checking the default
  496.       drive/directory, then by following the paths set by the MS-DOS "PATH"
  497.       command.  All Xlist options are identified by preceding keyword that start
  498.       with an asterisk "*".  When the first character is not an asterisk the
  499.       command line is treated as a comment.
  500.  
  501.       Following is description of the parameters specified in the Xlist.PRO file.
  502.       Optional parameters are designated by separation using the "|" and
  503.       parameters that need a numeric value specified use "n" to designate a
  504.       numeric value.  The default value is the first parameter specified or
  505.       underlined.
  506. Xlist.PRO PROFILE PARAMETERS
  507.  
  508.  
  509. *ALLATTR    OFF | ON | DISABLE
  510.  
  511.       The *ALLATTR is used in conjunction with changing the attributes of a MS-
  512.       DOS directory using the /A command.
  513.  
  514.       OFF         Only files under the specific directory will be changed.
  515.       ON          All files under the sub-directory will be changed.
  516.       DISABLE     Will not function on sub-directories.
  517.  
  518.  
  519. *BUFSIZE    32767 | nnnnn
  520.  
  521.       Use the *BUFSIZE command to assign the size reserved for "Xlist" to use
  522.       as a "COPY" Input / Output buffer.  The buffer is allocated the first time
  523.       the "COPY" command is used.  The size may be decreased down to 512
  524.       characters.  By decreasing the buffer size, performance of the "COPY"
  525.       command will be impaired.
  526.  
  527.  
  528. *DIRATTR    n+r+d+a | n+r+h+s+v+d+a
  529.  
  530.       The *DIRATTR command is used to define what attribute is used to search
  531.       the DOS directory.  This is used to setup a mask used during the search
  532.       of the directory to select what entries are included when displaying
  533.       directory entries on the Xlist screen.
  534.  
  535.       The attribute byte is mapped as follows:
  536.  
  537.       Value                   Description
  538.         n               Normal file
  539.         r               Read-only file
  540.         h               Hidden file
  541.         s               System file
  542.        *v               Volume label
  543.         d               Directory
  544.         a               Archival file
  545.  
  546. * Volume is not available on OS/2 operating systems. *DISABLE    [command]
  547.  
  548.       Xlist will intercept some MS-DOS commands,  this gives greater control to
  549.       Xlist when monitoring the directory and keeps MS-DOS from writing over
  550.       Xlist's screen.  The MS-DOS "Copy" & "Rename" command executed by Xlist
  551.       are not fully compatible with MS-DOS's "Copy" & "Rename" in that Xlist
  552.       won't allow wild cards in the source parameter.  Also, note that Xlist will
  553.       get a up to a 32K buffer, this will increase the size of Xlist and this
  554.       space won't be given back.  If you wish to use wild cards, either disable
  555.       the command or use the "DOS" command to use MS-DOS.
  556.  
  557.       Profile parameter *DISABLE command is used to disable MS-DOS commands
  558.       that Xlist will intercept.  The following commands can be disabled:
  559.  
  560.             *DISABLE COPY
  561.             *DISABLE DEL
  562.             *DISABLE ERASE
  563.             *DISABLE RENAME
  564.             *DISABLE REN
  565.             *DISABLE CHDIR
  566.             *DISABLE CD
  567.             *DISABLE MKDIR
  568.             *DISABLE MD
  569.             *DISABLE RMDIR
  570.             *DISABLE RD
  571.             *DISABLE MOVE
  572.  
  573.       It is to your advantage not to disable the above commands unless they
  574.       fail to perform to your expectations.  By allowing Xlist to intercept these
  575.       commands, it is better able to keep the command line up to date as changes
  576.       are made to the current directory.
  577.  
  578.  
  579.  
  580. *ENTRIES    500 | nnn
  581.  
  582.       The *ENTRIES command is used to provide a method for the user to specify
  583.       how much memory is used by Xlist to hold directory entry information.
  584.       Each directory is held in memory by Xlist to be displayed on the screen.
  585.       The maximum number of entries Xlist can load is 5900.
  586.  
  587.       Whenever there are more entries than set by the *ENTRIES command, the
  588.       excess entries are bypassed.
  589.  
  590.  
  591. *EXECUTE          [pattern] [commands......]
  592. *EXECUTE-ARC      [pattern] [commands......]
  593. *EXECUTE-LZH      [pattern] [commands......]
  594. *EXECUTE-ZIP      [pattern] [commands......]
  595. *EXECUTE-ZOO      [pattern] [commands......]
  596.  
  597.       The *EXECUTE command is used to associate a series of commands to be
  598.       entered when the ENTER key is pressed.  This can be used to invoke a
  599.       browser, editor, Lotus 1-2-3, DBASEIII, or any other series of commands.
  600.  
  601.       You can set up multiple *EXECUTE commands within the Xlist.PRO profile.
  602.        They are scanned sequential each time the ENTER key is pressed to see
  603.       if any commands should be entered if the pattern matches the name of the
  604.       active file.
  605.  
  606.       Example:
  607.  
  608.       To have a program called "LIST" invoked whenever the ENTER key is
  609.       pressed for all files that start with either an A, B, or C and the extension
  610.       is "DOC".
  611.  
  612.       *EXECUTE [ABC]*.DOC LIST
  613.  
  614.       To execute the Wordperfect word processor when ENTER key is pressed
  615.       beside all files having the .WP5 extension.
  616.  
  617.       *EXECUTE *.WP5 WP
  618.  
  619.  
  620. *HOTKEY     RIGHTSHIFT  |  LEFTSHIFT  |  ALT  |  CONTROL
  621.  
  622.       The *HOTKEY command is used to redefine the menu keyboard hotkey
  623.       combination used to bring up the menus.  The default is by pressing both
  624.       shift keys at the same time.  You must specify two of the four possible
  625.       values.  The default is pressing both the shift keys at the same time.
  626.       This is the same combination as the IRMA's 3270 emulator and should be
  627.       changed in that instance.
  628.  
  629.       Example:
  630.  
  631.       To define the alt & control combination to envoke the menus.
  632.  
  633.       *HOTKEY     ALT  CONTROL
  634.  
  635.  
  636. *KEYWAIT    5 | nn
  637.  
  638.       The *KEYWAIT command is used to tell Xlist for OS/2 the number of seconds
  639.       to wait before going into idle mode.  Where nn is the number of seconds
  640.       (between 1 and 99) to wait.  The default is 5.  (See *SLEEP command)
  641.  
  642.  
  643. *LINEEND    ~ | c
  644.  
  645.       The *LINEEND command is used to define the logical line end character.
  646.       For entering multiple commands on the same line for execution.  The
  647.       default character is the '~'.  This character may be put on the command
  648.       line or used within the *PFKEYS or *EXECUTE profile commands.
  649.  
  650.  
  651. *LOGO       ON | OFF
  652.  
  653.       The *LOGO command is used to disable the presentation of the initial
  654.       copyright screen.  This presentation delays Xlist execution for 3
  655.       seconds.
  656. *MOUSE      ON | OFF
  657.  
  658.       The *MOUSE command is used to disable the interface to the mouse pointer.
  659.       This can be used to keep Xlist from continuously checking for mouse
  660.       movements.  Initialization of the Microsoft PS/2 mouse causes a noticable
  661.       startup delay.  This is normal for Microsoft's PS/2 mouse interface.
  662.  
  663.  
  664.  
  665. *OVERLAY    OFF | ON  [SWAP_ANY  |  SWAP_EMS  |  SWAP_XMS  |  SWAP_DISK]
  666.  
  667.       The *OVERLAY command is used to maximize the amount of memory available
  668.       for commands invoked from within Xlist.  Xlist reduces the resident
  669.       portion of Xlist while another command is executed by temporarily
  670.       swapping the program to EMS, XMS, EXT, DOS 5 high memory or a disk file
  671.       when launching a application.  This will effectively reduce the memory
  672.       requirements of Xlist down to only 288 bytes.  The feature can be
  673.       toggled on and off by using the "/s" option on the command line.  OS/2
  674.       users shouldn't use the SWAP_ANY and SWAP_EXT option and should only
  675.       use the SWAP_EMS and SWAP_XMS option.
  676.  
  677.       SWAP_ANY - Will try all the methods starting with the SWAP_EXT
  678.         method.  This will cause a failure under OS/2 and shouldn't be
  679.         used.)  (default)
  680.       SWAP_EXT - Will swap to non-XMS extended memory.
  681.       SWAP_XMS - Will swap to XMS memory.
  682.       SWAP_EMS - Will swap to EMS memory.
  683.       SWAP_DISK - Will swap to a disk file pointed to by the TMP=
  684.         environment parameter.
  685.  
  686.       (Xlist uses the SPAWNO routines by Ralf Brown to minimize memory)
  687.  
  688.  
  689.  
  690. * *OVERLAY is not available on OS/2 operating systems. *PATHSZ     200 | nnn
  691.  
  692.       The *PATHSZ command is used to define the amount of memory reserved for
  693.       saving the DOS paths that have been previously been displayed during a
  694.       Xlist session.  This memory is automatically managed in conjunction with
  695.       use of the /BD command.
  696.  
  697. *PFKEYS           Xnn (btd) function
  698. *PFKEYS-ARC       Xnn (btd) function
  699. *PFKEYS-LZH       Xnn (btd) function
  700. *PFKEYS-ZIP       Xnn (btd) function
  701. *PFKEYS-ZOO       Xnn (btd) function
  702.  
  703.       This command provides the user with a method of defining the function
  704.       keys F1-F12 in order to execute commands using the function keys rather
  705.       than entering the command.  The function may be more than one command
  706.       each separated by the logical line end character (See *LINEEND for more
  707.       information). When viewing a ARC, LZH, ZOO or ZIP directory structure by
  708.       utilizing the /EXP, /ZIP, /LZH, /ZOO or /ARC commands, Xlist has the ability
  709.       to load another set of function key definitions.  These are specified by
  710.       appending "-ZIP", "-LZH", "ZOO" or "-ARC" upon the *PFKEYS keyword.
  711.  
  712.       The format for the command is as follows:
  713.  
  714.       *PFKEYS Xnn (btd) function
  715.  
  716.       X     = Shift key indicator.
  717.       blank = unshifted.
  718.       S     = right or left shift pressed.
  719.       C     = CTRL pressed.
  720.       A     = ALT pressed.
  721.       nn    = Function key number (1 through 12).
  722.       btd   = Abbreviation for display (optional).
  723.       function = Text inserted into Xlist command line.
  724.  
  725.       Examples:
  726.  
  727.       Set function key (F1) to compile a program using the Lattice C compiler.
  728.  
  729.       *PFKEYS 1 (lcs) lc -ms /c
  730.       Set function key (F2) to link-edit a program and cancel execution of Xlist.
  731.  
  732.       *PFKEYS 2 (lnk) link @xlistlk.lnk /o/c~/can
  733.  
  734.       Set function key (F3) to execute F1 & F2 commands.
  735.  
  736.       *PFKEYS 3 (all) /F1~/F2
  737.  
  738.       Set function key (F3) to un-zip active file using PKUNZIP to the
  739.       drive/directory specified by the TMP environment variable; execute a
  740.       program called "LIST" passing the name of the file as the first parameter;
  741.       erase the un-zipped file after execution of LIST.
  742.  
  743.       *PFKEYS-ZIP 3 (LIS) /cPKUNZIP -o $A %TMP% $F~LIST %TMP%$~ERASE %TMP%$
  744.  
  745.       Same as last example with LHA for a LZH archive entry with the TMPDRV
  746.       environment variable set to "D:" for a RAM drive.
  747.  
  748.       *PFKEYS-LZH 3 (LIS) /c%TMPDRV%~LHA -o $A %TMP% $F~LIST %TMP%$~ERASE
  749.       %TMP%$~/RESET
  750.  
  751.  
  752. *PFREF      OFF | ON
  753.  
  754.       The *PFREF command is used to tell Xlist to refresh the function key
  755.       definitions from the Xlist.PRO profile found in the current directory.
  756.       When Xlist senses that a drive or sub-directory change has occurred a
  757.       search is made in the current directory for the Xlist.PRO profile.  This
  758.       can be used to refresh the function key definitions between drives
  759.       and/or directories.
  760. *RETRACE    OFF | ON
  761.  
  762.       Profile parameter *RETRACE is used for IBM Personal Computers with IBM
  763.       Color/Graphics Monitor Adapters (CGA).  They require special programming
  764.       to prevent "snow" from appearing on the screen when a program changes
  765.       the contents of the screen buffer.  The required programming will slow
  766.       down screen updating and is not necessary for many other display
  767.       adapters.
  768.  
  769.       *RETRACE  ON
  770.  
  771.       Setting *RETRACE OFF on an IBM PC with an IBM color adapter will cause
  772.       "snow" on the screen in some instantaneous.
  773.  
  774.  
  775. *SLEEP      1000 | nnnnn
  776.  
  777.       This command controls idle mode.  It tells Xlist for OS/2 the number of
  778.       milliseconds to remain idle before checking for user input (keystrokes
  779.       or mouse movement).  Where nnnnn is the number of milliseconds (between
  780.       100 and 32000) to remain idle.  Any input cancels idle mode (after the
  781.       *SLEEP milliseconds expire).  The default is 1000.
  782.  
  783.  
  784. *SORT       [A | S | B | N | D | E | T][-]
  785.  
  786.       Profile parameter *SORT will cause Xlist to sort the directory before it
  787.       is displayed.  This will allow you to specify the order the entries are
  788.       arranged.
  789.  
  790.       The parameter definitions are:
  791.  
  792.             A     by attribute
  793.             S     by size
  794.             B     by blocksize (same as S)
  795.             N     by name
  796.             D     by date
  797.             E     by extension
  798.             T     by type (same as E, except sub-directories go to the top)
  799.  
  800.             -     descending order
  801. *TOPVIEW    OFF | ON
  802.  
  803.       The *TOPVIEW command is used to disable the access of the TOPVIEW video
  804.       buffer address.  Some video adapters have conflicts with the interrupts
  805.       used to access the TOPVIEW video buffer.  Setting this to the OFF setting
  806.       will make for faster screen access.
  807.  
  808.  
  809. *TREE       OFF | ON
  810.  
  811.       The *TREE command when set to "ON" will automatically load the directory
  812.       tree during startup of the Xlist program.  This will cause the startup of
  813.       Xlist to take a little longer.
  814.  
  815.  
  816. *TREEDATE   OFF | ON
  817.  
  818.       The *TREEDATE command is used to determine if the Xlist_x.LOG file
  819.       internal timestamp is to be used.  Xlist will create the file when scanning
  820.       directories.  The file is used when changing back to the drive in order to
  821.       save time.  You can instruct Xlist to use the file even if it was created
  822.       by a prior execution of Xlist by setting this option to the OFF position.
  823.       Xlist will execute faster, but, the directory tree may not reflect all
  824.       directories or show non-existent directories from previous executions
  825.       of Xlist.  You should reload the directory tree using the /RTREE command
  826.       when this occurs.
  827.  
  828.  
  829. *TREESCAN   OFF | ON
  830.  
  831.       The *TREESCAN command when set to "ON" will automatically preview files
  832.       within the directory.
  833.  
  834.  
  835. *VGAMODE    "Menu Title", "Font Filename"
  836.  
  837.       The *VGAMODE command is used in conjunction with EGA/VGA display
  838.       adapters that allows you to specify an optional character display table
  839.       (ie. FONT) to be loaded inplace of the resident fonts.  *VGAMODE commands
  840.       contain two pieces of information separated by a comma.  The first
  841.       parameter contains the heading contained in the menu within Xlist
  842.       corresponding to the specified FONT.  The heading must be contained
  843.       within double quotes, have two leading spaces and not exceed 40
  844.       characters in length.  The second parameter contains the MS-DOS file name
  845.       of the FONT.  This file is composed of 256 entrys between 8 to 14
  846.       characters in width.  These are the bitmaps for each possible character
  847.       from decimal 0 thru decimal 256.  You can create your own fonts by using
  848.       font editors that create normal MS-DOS character definition tables that
  849.       contain 256 entrys.
  850.  
  851.       If the *VGAMODE command isn't provided, Xlist will allow you to shift
  852.       between 25 line and 43 line modes using the alt-e keystoke or
  853.       corresponding menu commands.
  854.  
  855.       Some examples of font files are provided with Xlist which have the
  856.       extension of ".FNT".
  857. COMMAND LINE COMMANDS
  858.  
  859.  
  860. HOW TO USE THE COMMAND LINE
  861.  
  862.  
  863.       Xlist will present the directory vertically down the screen with a input
  864.       line next to each entry, this is the "COMMAND LINE".  The user can use the
  865.       cursor keys to navigate up and down the directory entering commands.
  866.       When the ENTER key is depressed, Xlist will process the commands from
  867.       top-to-bottom.  All commands entered are first examined by Xlist to find
  868.       special commands used by Xlist.  These commands are from logical line end
  869.       characters to special commands used to sort the directory into another
  870.       order.  Then Xlist will pass the commands to MS-DOS for execution.
  871.  
  872.       Based on a 80-column display, there are 33 characters that can be
  873.       presented to Xlist on the command line at any one time.  But, by continued
  874.       typing up to 63 characters can be entered.
  875.  
  876.       After the command is entered Xlist will append the filename and extension
  877.       name to the command unless told otherwise by the /o line command.
  878.  
  879.  
  880.       GENERAL NOTES:
  881.  
  882.       1.    Do not rename or erase files from a BAT file or with a "ERASE *.*"
  883.             sequence.
  884.  
  885.       These situations cannot be detected by Xlist and may result in random
  886.       displayed filenames or Xlist termination.  If you do the above, by
  887.       entering the "/RD" command, the directory is refreshed.
  888.  
  889. $       - SUBSTITUTE FILENAME & EXTENSION
  890.  
  891.       There are a series of characters using the '$' as a prefix that can be used
  892.       to imbed parameters into the command line automatically.
  893.  
  894.       /       -->  Substitute the DOS filename & extension.
  895.       //      -->  Will pass on one /.
  896.       $       -->  Substitute the DOS filename & extension.
  897.       $$      -->  Will pass on one $.
  898.       $P      -->  Substitute DOS pathname without trailing slash.
  899.       $N      -->  Substitute DOS filename without extension.
  900.       $E      -->  Substitute DOS extension.
  901.       $F      -->  Substitute DOS pathname, filename & extension.
  902.       $D      -->  Substitute DOS drive letter without trailing colon.
  903.  
  904.  
  905. /A      - CHANGE THE FILE ATTRIBUTES
  906.  
  907.       This command is used to modify the file attributes.  The attribute maybe
  908.       marked read-only, hidden, made a system file, or have the archive flag
  909.       turned on.
  910.  
  911.       When this is placed on a sub-directory, Xlist will change the attributes
  912.       of all the files within the directory. (See *ALLATTR profile command for
  913.       more information.)
  914.  
  915.       The format is:  /A[+/-][attribute]
  916.  
  917.       [+/-] the plus(+) is used to denote adding the attribute and the
  918.       negative(-) is used to remove an attribute.
  919.  
  920.       [attribute] is the one-character representation of the attribute to be
  921.       added or removed from the file.
  922.  
  923.             A  - Archive            R  - Read-only
  924.             H  - Hidden file        S  - System file
  925.             D  - Subdirectory
  926.  
  927. /AD     -  APPEND TO THE Xlist DIRECTORY
  928.  
  929.       The /AD command is used to append to the internal directory.  This can be
  930.       used to load additional entries from other drives or sub-directories.
  931.  
  932.       Examples:
  933.  
  934.       Set Xlist to only append the files with an extension of "EXE":
  935.  
  936.       /AD=*.EXE
  937.  
  938.       Append data from the root directory:
  939.  
  940.       /AD=C:\*.*
  941.  
  942.  
  943. /ARC    - EXPAND AN "ARC" FILE DIRECTORY
  944.  
  945.       Same function as the /EXP command for archive files with the ".ARC"
  946.       extension.  See the /EXP command for further details.
  947.  
  948.  
  949. /BD     - GO BACK TO PRIOR DIRECTORY
  950.  
  951.       This command is used to proceed back to previous sub-directory.
  952.       Whenever a sub-directory or drive change is made by entering the MS-DOS
  953.       CHDIR commands, Xlist will save the current directory in the path area
  954.       reserved by the *PATHSZ profile command.  By entering /BD the program
  955.       will automatically navigate back to the previous directory.
  956.  
  957.  
  958. /C      - CLEAR SCREEN BEFORE EXECUTING COMMAND
  959.  
  960.       When the /C is found in the command line it is extracted from the command
  961.       line and before the entered command is passed to the DOS command
  962.       processor the screen is cleared.  The video mode and character definition
  963.       table (font) is reset to MS-DOS's normal settings.  When a function key is
  964.       defined to invoke a program it is sometimes more appealing to have Xlist
  965.       clear the screen before invoking the program using the "/C" option.  This
  966.       also causes Xlist to clear and re-display the entire Xlist screen when
  967.       control is passed back from the program executed.
  968. /CAN    - CANCEL Xlist
  969.  
  970.       This command will exit Xlist and stay in the current directory and not
  971.       reset the video mode and character definition table (font) back to MS-
  972.       DOS's normal settings.
  973.  
  974.  
  975. /CLS    - CLEAR COMMAND LINE AREA
  976.  
  977.       This command will clear the Xlist command line area.
  978.  
  979.  
  980. DOS     - INVOKE SECONDARY COMMAND PROCESSOR
  981.  
  982.       Use the DOS command to pass control to the secondary DOS command
  983.       processor.  This command will load a copy of DOS and pass control to it.
  984.       You will remain in DOS until you return to Xlist by entering the EXIT
  985.       command.
  986.  
  987.       You should not execute any commands while in the secondary command
  988.       processor that will make them permanently resident.
  989.  
  990.  
  991. /DSPF   - DISPLAY USER-DEFINED FUNCTION KEYS
  992.  
  993.       You can use the /DSPF function to display the function keys currently
  994.       defined.
  995.  
  996.  
  997. /END    - END Xlist
  998.  
  999.       This command will exit Xlist and return to the drive and directory where
  1000.       Xlist was initially envoked.  This is the well-behaved ending of Xlist.
  1001.  
  1002. /EXE    - EXECUTE SPECIFIED PROGRAM
  1003.  
  1004.       The /EXE command is designed to be used in conjunction with the *EXECUTE
  1005.       profile command to specify the ".EXE", ".COM" and ".BAT" to be launched
  1006.       when the ENTER key is pressed next to the application executable
  1007.       program name.  This method presents a user-friendly window where you
  1008.       can specify additional parameters.
  1009. /EXP    - EXPAND AN "ARC", "LZH", "ZIP" or "ZOO" FILE DIRECTORY
  1010.  
  1011.       This command will read the directory contained within the specified
  1012.       archive file.  It will then display it using the Xlist directory display
  1013.       features.  Be aware that the /UD & /A sub-commands will be deactivated.
  1014.       To re-display the normal directory either press the ESC key or enter the
  1015.       /RD command.
  1016.  
  1017.       NOTE: You can use the /ZIP command to expand a ZIP file or /ARC to expand
  1018.       a ARC file or /LZH for LHA files.  The /EXP command determines whether it's
  1019.       a ZIP, LZH or ARC file from the file extension.
  1020.  
  1021.  
  1022. /F[x]nn  - EXECUTE FUNCTION KEY
  1023.  
  1024.       This command can be used to invoke function keys from the command line.
  1025.       As a matter of fact, when a function key is depressed Xlist will insert
  1026.       into the command line the above command.  The [x] position can either be
  1027.       blank, 'A' for Alt, 'S' for shift or 'C' for ctrl followed by the function key
  1028.       value from 1 through 10.
  1029.  
  1030.       Example:
  1031.  
  1032.       To invoke the F4 function key you would enter "/F4".
  1033.       To invoke the alternate F4 function key you would enter "/FA4".
  1034.  
  1035.  
  1036. /FIND    - FIND FILES ON CURRENT DRIVE
  1037.  
  1038.       The /FIND command will search the current drive locating all files that
  1039.       match the selection criteria specified with the /FIND command.  The
  1040.       results are displayed as if the files are all contained on the same
  1041.       drive/directory. To re-display the normal directory either press the ESC
  1042.       key or enter the /RD command.
  1043.  
  1044.       Examples:
  1045.  
  1046.       Find all batch files that start with either a "A" or "B".  The right and left
  1047.       bracket is used to specify optional characters in a specified location
  1048.       within the name.  The normal "*" and "?" wildcard characters can also be
  1049.       used.
  1050.  
  1051.       /FIND=[AB]*.BAT
  1052.       Find all files with the extension of WK1.
  1053.  
  1054.       /FIND=*.WK1
  1055.  
  1056.  
  1057. /LZH    - EXPAND AN "LZH" FILE DIRECTORY
  1058.  
  1059.       Same function as the /EXP command for archive files with the ".LZH"
  1060.       extension.  See the /EXP command for further details.
  1061.  
  1062.  
  1063. MOVE    - MOVE FILE
  1064.  
  1065.       Use the MOVE command to move a file from one directory to another
  1066.       directory on the same drive.  This program uses a feature of the DOS
  1067.       RENAME function that will logically move a file from on directory to
  1068.       another.  This command will also change the name of the file during the
  1069.       move if you wish.
  1070.  
  1071.  
  1072. /O      - OMIT THE FILENAME & EXTENSION FROM COMMAND
  1073.  
  1074.       When the /O is found in the command line it is extracted from the command
  1075.       line and before the entered command is passed to the DOS command
  1076.       processor the screen is cleared.
  1077.  
  1078.       This command is used to keep Xlist from appending the filename and
  1079.       extension to the end of the command entered on the command line.  This
  1080.       can be useful when entering DOS commands from the command line, since in
  1081.       most cases the filename shouldn't follow the command.
  1082.  
  1083.  
  1084. /P      - PAUSE AFTER EXECUTING COMMAND
  1085.  
  1086.       When the /P is found in the command line it is extracted from the command
  1087.       line and before the entered command is passed to the DOS command
  1088.       processor the screen is cleared.
  1089.  
  1090.       The /P command is used to cause Xlist to pause after executing the
  1091.       command entered on the command line.  This can be used in conjunction
  1092.       with the /C command to allow the screen to be viewed before Xlist takes
  1093.       control and refreshes the screen. /RD     - RELOAD THE Xlist DIRECTORY AND RESET MASK
  1094.  
  1095.       The /RD command is used to reload the Xlist internal directory.  This can
  1096.       be used to refresh the current directory when modules are added or when
  1097.       directory clean-up is necessary.
  1098.  
  1099.       At this time a optional parameter can be entered resetting the mask used
  1100.       to select the entries to reload.
  1101.  
  1102.       Examples:
  1103.  
  1104.       Set Xlist to only load the files with an extension of "EXE":
  1105.  
  1106.       /RD=*.EXE
  1107.  
  1108.       Reload the directory with the default mask:
  1109.  
  1110.       /RD
  1111.  
  1112.  
  1113. /RESET  - RESET TO CURRENT DRIVE & DIRECTORY
  1114.  
  1115.  
  1116.       You may stack a series of commands that take you to another drive or
  1117.       directory.  When returning to Xlist from executing all commands, Xlist will
  1118.       sense the drive or directory change and reload the directory list.
  1119.       Normally, you what Xlist to execute in this fashion.  But, in special cases
  1120.       where you would like to stay in the current drive and directory then
  1121.       execute this as the last command to reset to the current drive and
  1122.       directory.
  1123.  
  1124.       Example:
  1125.  
  1126.       An example is provided extracting an entry from a LZH archive file to a
  1127.       temporary drive and directory, view the file and delete the file.  Without
  1128.       the /reset command Xlist would sense the drive/directory change and
  1129.       reload from the temporary drive.
  1130.  
  1131.       E:~LHA e $A $F~LIST $~ERASE $~/reset
  1132.  
  1133.       The command above would switch to the E: drive, extract the current LZH
  1134.       entry to the E: drive, view the entry with the LIST program, erase the file
  1135.       then return to the previous drive/directory. /RF     - RE-FRESH THE Xlist FUNCTION KEYS
  1136.  
  1137.       The /RF command is used to refresh the Xlist function definitions.  This
  1138.       is useful when the "Xlist.PRO" file is changed and you want the changes
  1139.       to take effect.
  1140.  
  1141.  
  1142. /S      - TOGGLE *OVERLAY OPTION ON or OFF
  1143.  
  1144.       The /S command is used when launching a application to toggle the use of
  1145. the *OVERLAY profile command on or off.  If the *OVERLAY profile command
  1146. is disabled, the use of /S will temporarily enable the option for this
  1147. execution of one application.
  1148.  
  1149.  
  1150. /Sx[-]  - SORTING DIRECTORY
  1151.  
  1152.       The following methods maybe used to sort the directory:
  1153.  
  1154.       /SA   Sort by file attribute
  1155.       /SE   Sort by extension
  1156.       /SB   Sort by filesize
  1157.       /SN   Sort by name
  1158.       /SD   Sort by file maintenance date
  1159.       /ST   Sort by extension, directories to top
  1160.  
  1161.       The command maybe optionally followed by a "-" to denote a reverse sort
  1162.       sequence.
  1163.  
  1164.  
  1165. /SET    - SET FUNCTION KEYS
  1166.  
  1167.       This command provides the user with a method of defining the function
  1168.       keys F1-F12 interactively while Xlist is currently executing.  This
  1169.       command follows the same rules under which the *PFKEYS profile command
  1170.       follow.
  1171.       The format for the command is as follows:
  1172.  
  1173.       /SET Xnn (btd) function
  1174.  
  1175.       X           = Shift key indicator
  1176.       blank       = unshifted
  1177.       S           = right or left shift depressed
  1178.       C           = CTRL depressed
  1179.       A           = ALT depressed
  1180.       nn          = Function key number (1 through 12)
  1181.       btd         = Abbreviation for display (optional)
  1182.       function    = Text of command line
  1183.  
  1184.  
  1185. /START  - START AN OS/2 SESSION (OS/2 ONLY)
  1186.  
  1187.       This command will allow you to start a new session using the capabilities
  1188.       of the DosStartSession OS/2 function.  The command will search the PATH
  1189.       when the full full qualified name is not provided.  If a ICON is located in
  1190.       the same path as the program with the extension of .ICO, it will be used as
  1191.       the ICON.  The syntax of the command is:
  1192.  
  1193.       /START [-TIT:title] [-NOC] [-BG] [-FS | -PM | -WIN] [-I] [-MIN | -MAX] {program
  1194.       name} [program arguments]
  1195.  
  1196.       Parameters:
  1197.  
  1198.       title       Specify the title to assign to the session which is displayed
  1199.                   on the Presentation Manager menu and session window.
  1200.  
  1201.       -NOC        Specify not to close the window when the program ends.
  1202.  
  1203.       -BG         Start the program in the background.
  1204.  
  1205.       -FS         Start the program as a full screen session. (NOTWINDOWCOMPAT)
  1206.  
  1207.       -PM         Start the program as a PM session. (WINDOWAPI)
  1208.  
  1209.       -WIN        Start the program as PM compatible. (WINDOWCOMPAT)
  1210.       -I          Pass current environment settings to the starting session.
  1211.  
  1212.       -MIN        Set window state as MINIMIZED.
  1213.  
  1214.       -MAX        Set window state as MAXIMIZED.
  1215.  
  1216.       -CMD        Invoke the program session using CMD.EXE.
  1217.  
  1218.       -K          Invoke the program session using CMD.EXE with the /k option
  1219.                   that keeps the session when terminated.
  1220.  
  1221.  
  1222. /TREE   - Xlist DIRECTORY STRUCTURE
  1223.  
  1224.       This command will load a graphic directory tree of the current drive.
  1225.       From within the directory tree, you can navigate to other
  1226.       sub-directories, create directories, and delete directories.
  1227.  
  1228.       To reload a directory tree use the /RTREE command.
  1229.  
  1230.  
  1231. /UD     - UPDATE DIRECTORY ENTRY WITH CURRENT DATE & TIME
  1232.  
  1233.       The /UD command is used to modify a directory entries date and time.  When
  1234.       the command is entered with no operands the corresponding directory
  1235.       entries date is set to the currently set DOS date and time.
  1236.  
  1237.       The /UD command can optionally be followed be either a date or a time
  1238.       which is recognize by Xlist by the dash for date and the colon for time.
  1239.       These separator characters are specified by MS-DOS using the COUNTRY
  1240.       command in CONFIG.SYS.
  1241.  
  1242.       Example:
  1243.  
  1244.       Set date to current date & time:          /UD
  1245.       Set date to July 2, 1985:                 /UD=07-2-85
  1246.       Set time to 12:00 noon:                   /UD=12:00:00
  1247.  
  1248. /V      - VERIFY ON ERASE or VERBOSE ON COPY
  1249.  
  1250.       When the /V is found in the command line it is extracted from the command
  1251.       line and before the entered command is passed to the DOS command
  1252.       processor the screen is cleared.
  1253.  
  1254.       The /V command in conjunction with the ERASE command will prompt the
  1255.       user to erase the file or not.  With the COPY command, Xlist will display
  1256.       the entry being copied.
  1257.  
  1258.  
  1259. /ZIP    - EXPAND AN "ZIP" FILE DIRECTORY
  1260.  
  1261.       Same function as the /EXP command for archive files with the ".ZIP"
  1262.       extension.  See the /EXP command for further details.
  1263.  
  1264.  
  1265. /ZOO    - EXPAND AN "ZOO" FILE DIRECTORY
  1266.  
  1267.       Same function as the /EXP command for archive files with the ".ZOO"
  1268.       extension.  See the /EXP command for further details.
  1269.  
  1270.  
  1271. /nnn    - DISPLAY DIRECTORY STARTING WITH nnn ENTRY
  1272.  
  1273.       The /nnn command is used to make Xlist display the current screen
  1274.       starting with the nth directory entry.  You can use the +- signs to
  1275.       position an offset from the current position.
  1276.  
  1277.       Examples:
  1278.  
  1279.       /80         Position to the 80th entry in the list.
  1280.       /+1         Position to next entry.
  1281.       /-1         Position to previous entry.
  1282.       /999        If the number is greater than the number of entries, Xlist
  1283.                   will position to the last entry.
  1284.       /1          Position to the 1st entry.
  1285.  
  1286.  
  1287. ?       - REDISPLAY LAST COMMAND ENTERED
  1288.  
  1289.       The ? command will cause Xlist to display the last command entered on the
  1290.       command line.
  1291.  
  1292. =       - REPEAT THE LAST COMMAND ENTERED
  1293.  
  1294.       The = command will cause Xlist to execute the last command entered for
  1295.       the directory entry adjacent to the command line where the = command is
  1296.       entered.
  1297.